Software Vault: The Diamond Collection

home *** CD-ROM | disk | FTP | other *** search

/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr20 / prng154c.zip / PRINTGL2.DOC < prev next >

Wrap

Text File | 1995-01-12 | 29KB | 663 lines

PrintGL 1.54 HP-GL, HP-GL/2, and ADI Commands (c) Copyright Ravitz Software Inc. 1990,1995 Ravitz Software Inc. BBS/FAX 606-268-0577 P.O. Box 25068 Lexington, KY 40524-5068 USA Compuserve Cary Ravitz [70431,32] ------------------------------ Contents ------------------------------ PrintGL Initial Information File ......................... PRINTGL.TXT PrintGL Documentation File PRINTGL.DOC Introduction ....................................................... 3 HP-GL Commands 3 HP-GL/2 Commands .................................................. 11 ADI Commands 13 HP-GL Character Sets .............................................. 14 p-3 Introduction --------------------------------------------------------- This document is a description of the subset of HP-GL (Hewlett-Packard Graphics Language), HP-GL/2, and ADI (Autodesk Device Interface) that is supported by PrintGL. If you are using PrintGL to work with commercial graphics software, then you will probably not need this manual. If you are writing graphics software you will find here the information needed to make your output compatible with PrintGL. HP-GL Commands ------------------------------------------------------- PrintGL's HP-GL specification is taken from the programming manuals for the HP 7475A, ColorPro (7440/17440), and 7550A. The 7550 manual is the best reference for HP-GL - HP manual 07550-90001. PrintGL supports the 7475, and 7440/17440 command sets except for character set 8 (Katakana), digitize commands, output commands, the error mask command, and some device control commands. Supported commands are listed below. Commands that are not applicable to printing, such as pen velocity, are considered supported but are completely ignored. Commands that are not supported are flagged and then ignored. In addition, PG, AF, ES, LO, the enhanced IW command, character set 5, and proportional spaced fonts, from the 7550, are supported. And forty pens are allowed instead of eight. In reading a plotfile, PrintGL ignores carriage returns, line feeds, and nulls except where they may be valid characters (LB, SM, DT, esc.), and ASCII EOF (026) is interpreted as an end of file mark. AA x_center , y_center , arc_angle [, chord_angle] Arc absolute - AA moves the pen through an arc, starting at the current position, with the pen in the current up/down state. AF Advance full page - AF starts a new plot. PrintGL starts every page with the pen up at 0,0. AP Automatic pen pickup - IGNORED AR x_center_delta , y_center_delta , arc_angle [, chord_angle] Arc relative - AR moves the pen through an arc, starting at the current position, with the pen in the current up/down state. AS Acceleration select - IGNORED p-4 CA character_set Designate alternate character set - See HP-GL Character Sets for a list of character sets. CI radius [, chord_angle] Circle - CI draws a circle centered at the current position. The current up/down state and position are unchanged by a CI command. CP [spaces , lines] Character plot - CP moves the pen by character spaces (+ is along the text) and lines (+ is up), using the current up/down state. Using no parameters is the same as a carriage return/line feed. CS character_set Designate standard character set - See HP-GL Character Sets for a list of character sets. CV Curved line generator - IGNORED DF Default values - This sets default values for the following commands: CA, CS, DR, DT, ES, FT, IW, LO, LT, PA, PT, SC, SM, SL, SR, SS, TL. DI [run , rise] Absolute character direction - DI sets the baseline direction for labels. The default is 1,0. DR [run , rise] Relative character direction - DR sets the baseline direction for labels. Run and rise are a percentage of P2X-P1X and P2Y-P1Y. The default is 1,0. DTt Define label terminator - The label terminator ends an LB command. The default is ASCII 003. EA x_opposite_corner , y_opposite_corner Edge rectangle absolute - EA draws a rectangle defined by the current position and the parameters. The pen position and up/down state are unchanged. EC Enable cutter - IGNORED p-5 EP Edge polygon - EP draws the current polygon edge. Any pen up/down used in creating the polygon is respected in drawing the edge. ER x_opposite_corner_delta , y_opposite_corner_delta Edge rectangle relative - ER draws a rectangle with corners defined by the current position and the command parameters. The current pen position and up/down state are unchanged. ES [ space [, line]] Extra space - ES adds to the space between characters and lines. The units are in character cells (1.5*width, 2*height). The allowed range is -1 to 1. -.3333 causes characters to touch. EW radius , start_angle , sweep_angle [, chord_angle] Edge wedge - EW draws a wedge centered at the current position. The current pen position and up/down state are unchanged. FP Fill polygon - FP fills the current polygon. Pen up/down commands used in creating the polygon are ignored. There is a limit of 4000 fill line segments per polygon. FS Force select - IGNORED FT [type [, spacing [, angle]]] Fill type - These are the fill types. Type 2 is identical to type 1 for PrintGL. 1 solid lines spaced at half the pen thickness (see PT command) 2 unidirectional solid lines spaced at half the pen thickness 3 lines at the specified spacing 4 cross hatched lines at the specified spacing 5 type ignored A spacing parameter of 0 sets the spacing to 1% of the P1-P2 diagonal. Spacing is in x axis units (this is only relevant if the axes have different scaling). PrintGL supports any integer angle for fill. Cross hatched lines are at angle + 90. IN Initialize p-6 IP [p1x , p1y [, p2x , p2y]] Sets scaling points P1 and P2 - IP sets the scaling points (P1 and P2) in plotter units. P1 and P2 are used by several commands to help with size independent plots. IW [x_lower_left , y_lower_left , x_upper_right , y_upper_right] Input window - IW sets a clipping window in plotter units. With no parameters, the clipping window is turned off. If PrintGL's /YE switch is set and user scaling is on then IW parameters are in user units. In this case the window is rescaled with an IP command, but any SC command locks the current window. LB..text..terminator Label - Labels use the current character set, based on CA, CS, SA, and SS commands. See HP-GL Character Sets for font specifics. LO [ position_number ] Label origin - LO sets the label origins, shown below. For positions 4..9 and 14..19 the label buffer is limited to 150 characters. The default is 1. 13 16 19 3...... ....... ...6... ....... ......9 . . . . . . . . . . 12 2 . . . . 5 . . . . 8 18 . . . . . . . . . . 1...... ....... ...4... ....... ......7 11 14 17 LT [pattern_number [, pattern_length]] Line type - PrintGL's line type patterns are close to, but not identical to HP's. Pattern length is a percentage of the P1-P2 diagonal with a default of 4% and a minimum of 4 dots for types 1 and 2 and 16 dots for other types. Negative (adaptive) line types from the HP 7550 are supported. no parameter solid 1 . . 2 ________ ________ 0 dots at 3 ____________ ____________ endpoints 4 ____________ . ____________ . only 5 __________ __ __________ __ 6 ______ __ __ ______ __ __ 7 __________ . . __________ . . 8 ______ . __ . ______ . __ . PA [x , y] [, x , y] ... Plot absolute - PA sets absolute mode and optionally moves the pen in the current up/down state. p-7 PD [x , y] [, x , y] ... Pen down - PD sets the pen down and optionally moves it with the current absolute/relative mode. PG [i] New page - PG starts a new plot. The parameter is ignored. PrintGL starts every page with the pen up at 0,0. PM i Polygon mode - PM 0 starts polygon mode. The current position is the first point in the polygon. PM 1 starts a new subpolygon. The position after the next pen movement is the first point in the subpolygon. The first pen move of a subpolygon is done with the pen up, regardless of the current up/down status. PM 2 ends polygon mode. PM 1 and PM 2 close the current subpolygon with the current pen up/down state. If used without first starting polygon mode (PM 0), PrintGL adds an implied PM 0 before processing the PM 1 or PM 2. The following commands are accepted in polygon mode: PM, PA, PR, PU, PD, AA, AR, CI (circles are automatically prefixed and suffixed by PM 1), and IN. The polygon buffer is limited to 1000 data points. PR [x_delta , y_delta] [, x_delta , y_delta] ... Plot relative - PR sets relative mode and optionally moves the pen in the current up/down state. PS Paper size - IGNORED PrintGL ignores PS. The paper size must be set with the /L option. PT [thickness] Pen thickness - PT specifies twice the line spacing used in solid fills and may be from 0 to 5.0 mm. It is reset to .3 mm with each SP command. PU [x,y] [,x,y] ... Pen up - PU raises the pen and optionally moves it with the current absolute/relative mode. p-8 RA x_opposite_corner , y_opposite_corner Shade rectangle absolute - RA fills a rectangle with corners defined by the current position and the command parameters. The current pen position and up/down state are unchanged. The rectangle edge is not drawn. RO [angle] Rotate coordinate system - RO or RO0 sets up a normal coordinate system. RO90, the only other allowed value, sets up a system that is rotated 90 degrees. The type of rotation depends on the paper size. This command does not change the scaling points, so an IP command is useful after an RO. The HP 7475 specifies two different meanings for RO90 depending on the paper size (A/A4 or B/A3). PrintGL decides which type of rotation to do based on the sum of the print window width and height. If this sum is greater than 24 inches then large paper rotation is used. Otherwise, small paper rotation is used. Small paper rotation: Large paper rotation: RO 0 RO 90 RO 0 RO 90 y -------- 0,0 -------- y 0,0 -------- y y -------- | | | | | | | | | | | | | | | | 0,0 -------- x x -------- | | | | | | | | | | | | | | | | x -------- 0,0 -------- x RR x_opposite_corner_delta , y_opposite_corner_delta Shade rectangle relative - RR fills a rectangle with corners defined by the current position and the command parameters. The current pen position and up/down state are unchanged. The rectangle edge is not drawn. SA Select alternate character set - SA specifies the alternate character set as current. The alternate character set is chosen with CA. SC [xmin , xmax , ymin , ymax] or SC xmin,xrto,ymin,yrto,2 Scaling - SC sets user units. The units are defined by user values for P1 (xmin,ymin) and P2 (xmax,ymax) or P1 and the ratio of plotter to user units. Using no parameters turns scaling off, and subsequent drawing is done in plotter units (1/1016 inch). p-9 SI [width , height] Character size absolute - SI sets the capital letter box width and height in centimeters. Letter spacing is 1.5 * width and line spacing is 2 * height. Using no parameters with B or A3 paper is the same as SI.285,.375 and any other paper is the same as SI.187,.269. SL [tan_angle] Character slant - SL sets the character slant. The parameter is interpreted as the tangent of the angle from vertical. Using no parameter sets the slant to 0 degrees. SM[c] Symbol mode - SM sets symbol mode, which centers the symbol mode character at any plotted point. Any character from ASCII 033 to 127 except ";" sets symbol mode. Any other character turns symbol mode off. SP pen_number Select pen - SP selects a pen. Using 0 or no parameter stores the pen without selecting a new pen. This is usually done at the end of a plot. PrintGL ignores any drawing with pen 0. SR [width , height] Character size relative - SR sets the capital letter box width and height as a percentage of P2X-P1X and P2Y-P1Y. Letter spacing is 1.5 * width and line spacing is 2 * height. Using no parameters is the same as SR.75,1.5. SS Select standard character set - SS specifies the standard character set as current. The standard character set is chosen with CS. TL [positive_length [, negative length]] Tick length - TL sets the tick lengths used by XT and YT. The parameters are lengths above and below the current position as a percentage of P2Y-P1Y for x-axis ticks and a percentage of P2X-P1X for y-axis ticks. UC [[pen_control ,] x_delta , y_delta] ... User character - UC specifies a user defined character. The pen control number is 99 for pen down or -99 for pen up. Pen movements are relative, with x_delta in units of 1/4 the character width and y_delta in units of 1/8 the character height. VA Adaptive velocity - IGNORED p-10 VN Normal velocity - IGNORED VS Pen velocity - IGNORED WG radius , start_angle , sweep_angle [, chord_angle] Shade wedge - WG fills a wedge centered at the current position. The current pen position and up/down state are unchanged. The wedge edge is not drawn. XT X-axis tick - XT draws a vertical line, with length specified by the TL command, at the current position. The pen position and up/down state are unchanged. YT Y-axis tick - YT draws a horizontal line, with length specified by the TL command, at the current position. The pen position and up/down state are unchanged. esc.( esc.Y Plotter on - Esc.( and esc.Y turn the plotter on. This is only relevant with the /YY option. esc.) esc.Z Plotter off - Esc.) and esc.Z turn the plotter off. They are only effective with the /YY option. The plotter on and off commands let you include comments or data to pass through to another device in the plotfile. These are flagged as unsupported commands if /YD is set, as an indication that you should set /YY. esc.@, esc.H, esc.I, esc.M, esc.N, esc.R RS-232 device control commands - IGNORED p-11 HP-GL/2 Commands ----------------------------------------------------- PrintGL's HP-GL/2 commands include a subset of HP-GL/2 that lets you take advantage of HP-GL/2's pen control and data compression. PrintGL's HP-GL/2 interpreter reads all of the HP-GL commands above, except as noted below. PrintGL acts like an HP-GL/2 plotter, not printer, so form feeds are done with the PG command not the form feed character. The LA command is not supported - all lines are drawn with round ends and round joints. And all clipping is done to the line center. When the output format is HP-GL all of the HP-GL/2 extended pen control commands are ignored. The PT command is needed to ensure solid fills look good. AC [x , y] Anchor corner - AC specifies the origin of stroked fills. It is handled even with HP-GL/2 off. BP Begin plot - BP is interpreted as PG;IN;. It is handled even with HP-GL/2 off. CO "comment" Comment - This is handled even with HP-GL/2 off. CR [black_ref_red , green , blue , white_ref_red , green , blue] Color range - Sets the color ranges used by the PC command. FT [type [, spacing or shading [, angle]]] Fill type - When reading HP-GL/2, PrintGL accepts type 10 (shading percentage is the additional parameter) and 11 (raster fill number is the additional parameter). Type 11 fills are converted to type 10 with the shade level taken from the RF command. For solid and shaded fill types, to guarantee good results, you must use the PW command to set the pen width and this width must magnify to no more than 24 dots in the final image. If either of these rules is broken, the fill may be striped rather than solid. IR [p1x , p1y [, p2x , p2y]] Set scaling points relative - This is handled even if HP-GL/2 is turned off. LT [pattern_number [, pattern_length, [mode]]] Line type - HP-GL/2 allows the additional parameter to select relative (default) or absolute (in mm) pattern lengths. This is handled even with HP-GL/2 off. p-12 NP [number] Number of pens - Sets the number of pens. This is ignored by PrintGL, which can handle up to 256 pens. PC [pen [, red , green , blue]] Pen color - Sets the pen color. PE Polyline encoded - This starts PE mode. It is handled even with HP-GL/2 off. PT [thickness] Pen thickness - The command is not part of HP-GL/2 and is generally ignored. If the output format is HP-GL or if you are using /Y1 (HP-GL/2 without pen control) then PT is interpreted as it is in HP-GL. PW [width [, pen]] Pen width - Sets the pen width. After magnification, the maximum width is 24 dots. PW is ignored if the output format is HP-GL. QL Quality level - IGNORED for HP-GL or HP-GL/2 RF [index [,width, height, pen [.. pen]] Raster fill - RF is not fully implemented. Instead it is read and the pattern is converted to a shade level. Pen numbers and the specific pattern are ignored. The shade level is saved for use with fill type 11. RO [angle] Rotate coordinate system - When reading HP-GL/2, this command accepts 0, 90, 180, and 270 and always rotates counter-clockwise. SV [type [, option1 [, option2]]] Screened vectors - Sets the shade level used to draw lines. Only modes 0 and 1 are supported. TR [mode] Transparency mode - Sets opaque or translucent mode. UL [index [,gap1, .., gapn]] User line type - UL is not fully implemented. Instead it is read and the pattern is converted to one of PrintGL's eight standard line types. The gaps must be less that 256. p-13 WU [type] Width units - Sets the units used by the PW command. esc% .. A Enter PCL or RTL mode - This command is treated like esc.). All commands are ignored until the next esc% .. B. esc% .. B Enter HP-GL/2 mode - This command is treated like esc.(. It is required before any commands are interpreted. ADI Commands --------------------------------------------------------- With the /YA option PrintGL can read Autodesk ADI 4.0 vector plotter binary commands intermixed in the HP-GL. 1016 dpi coordinates or the current HP-GL user coordinates are assumed. The table shows each ADI command and the equivalent HP-GL command (as interpreted by PrintGL). In the ADI code column, the code number and "b"s are bytes, and "x" and "y" are words. Eight line types (other than solid) are supported. ADI command ADI code equivalent HP-GL begin plot 1 b ignored end plot 2 PG; move 3 x y PUx,y; draw 4 x y PDx,y; pen 5 b SPb; speed 6 b ignored line type 7 b if b=0 then LT; else LTb,2; raise pen 8 ignored abort 9 ignored p-14 HP-GL Character Sets ------------------------------------------------- PrintGL supports all of the character sets that are included with the HP 7475 and 7440/17440 except Katakana, and adds character set 5 and the proportional spaced fonts from the 7550. PrintGL's characters are similar to but not identical to HP's. 0 ANSI ASCII 30 ISO Swedish 1 9825 character set 31 ISO Swedish For Names 2 French/German 32 ISO Norway Version 1 3 Scandinavian 33 ISO German 4 Spanish/Latin American 34 ISO French 5 Special Symbols (7550 extension) 35 ISO United Kingdom 6 JIS ASCII 36 ISO Italian 7 Roman Extensions 37 ISO Spanish 8 Katakana - NOT SUPPORTED 38 ISO Portuguese 9 ISO IRV 39 ISO Norway Version 2 The character sets specify a font for codes 033..127. Codes 000..032 and 128..255 are independent of the character set and are all no ops except these. 003 default label terminator 008 backspace 013 carriage return 009 half backspace 014 select alternate character set 010 line feed 015 select standard character set 011 reverse line feed 032 space Each of the character sets is available as a proportional font by adding 10 to the set number. The proportional fonts are kerned to improve appearance (the character spacing is adjusted to compensate for character shape). Use the LO command to simplify working with proportional fonts. To improve the appearance of large text, use the ES command to reduce the character spacing. Codes 65 to 81 in character set 5 are symbols designed to be used in symbol mode (SM command) or as one character labels. When used in a label (LB command) these characters are centered at the current pen position and leave the pen position unchanged. p-15 The HP-GL characters cannot be printed with the standard ASCII character set. The file PRINTGL2.CHR is an HP-GL file that can be used to print a replacement for this page, showing the character sets. Set up PrintGL with "magnification" "magnify: 1.0", "position" "plot: 0.0,0.0 at print origin", and "window/margins" "default" to print this plotfile.